org.springframework.core.convert.support

Class CollectionToCollectionConverter

java.lang.Object

org.springframework.core.convert.support.CollectionToCollectionConverter

All Implemented Interfaces:

ConditionalConverter, ConditionalGenericConverter, GenericConverter

final class CollectionToCollectionConverter
extends java.lang.Object
implements ConditionalGenericConverter

Converts from a Collection to another Collection.

First, creates a new Collection of the requested targetType with a size equal to the size of the source Collection. Then copies each element in the source collection to the target collection. Will perform an element conversion from the source collection's parameterized type to the target collection's parameterized type if necessary.

Since:

3.0

Author:

Keith Donald, Juergen Hoeller

Nested Class Summary

Nested classes/interfaces inherited from interface org.springframework.core.convert.converter.GenericConverter

GenericConverter.ConvertiblePair

Field Summary

Fields

Modifier and Type	Field and Description
private ConversionService	conversionService

Constructor Summary

Constructors

Constructor and Description
CollectionToCollectionConverter(ConversionService conversionService)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	convert(java.lang.Object source, TypeDescriptor sourceType, TypeDescriptor targetType) Convert the source to the targetType described by the TypeDescriptor.
java.util.Set<GenericConverter.ConvertiblePair>	getConvertibleTypes() Return the source and target types which this converter can convert between.
boolean	matches(TypeDescriptor sourceType, TypeDescriptor targetType) Should the conversion from sourceType to targetType currently under consideration be selected?

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

conversionService

private final ConversionService conversionService

Constructor Detail

CollectionToCollectionConverter

public CollectionToCollectionConverter(ConversionService conversionService)

Method Detail

getConvertibleTypes

public java.util.Set<GenericConverter.ConvertiblePair> getConvertibleTypes()

Description copied from interface: GenericConverter

Return the source and target types which this converter can convert between. Each entry is a convertible source-to-target type pair.

For conditional converters this method may return null to indicate all source-to-target pairs should be considered.

Specified by:

getConvertibleTypes in interface GenericConverter

matches

public boolean matches(TypeDescriptor sourceType,
                       TypeDescriptor targetType)

Description copied from interface: ConditionalConverter

Should the conversion from sourceType to targetType currently under consideration be selected?

Specified by:

matches in interface ConditionalConverter

Parameters:

sourceType - the type descriptor of the field we are converting from

targetType - the type descriptor of the field we are converting to

Returns:

true if conversion should be performed, false otherwise

convert

public java.lang.Object convert(java.lang.Object source,
                                TypeDescriptor sourceType,
                                TypeDescriptor targetType)

Description copied from interface: GenericConverter

Convert the source to the targetType described by the TypeDescriptor.

Specified by:

convert in interface GenericConverter

Parameters:

source - the source object to convert (may be null)

sourceType - the type descriptor of the field we are converting from

targetType - the type descriptor of the field we are converting to

Returns:

the converted object